<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html lang="en">
<head>
<meta name="copyright" content="Copyright (c) 2014 IBM Corporation and others. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." >
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<meta http-equiv="Content-Style-Type" content="text/css">
<link rel="STYLESHEET" href="../../book.css" charset="ISO-8859-1" type="text/css">
<title>Incompatibilities between Eclipse 4.4 and 4.5</title>
</head>

<body>

<h1>Incompatibilities between Eclipse 4.4 and 4.5</h1>

<p>
  Eclipse changed in incompatible ways between 4.4 and 4.5 in ways that affect
  plug-ins. The following entries describe the areas that changed and provide
  instructions for migrating 4.4 plug-ins to 4.5. Note that you only need to look
  here if you are experiencing problems running your 4.4 plug-in on 4.5.
</p>
<p>
See also the list of <a href="../removals.html">deprecated API removals</a> for this release.
</p>

<ol>
	<li><a href="#locale">Eclipse context key Translation.LOCALE provides the Locale type</a></li>
	<li><a href="#xinternal">Package org.eclipse.e4.ui.workbench.addons.splitteraddon marked as non-API</a></li>
	<li><a href="#deprecatedevents">New monitoring events added in place of SWT.Sleep and SWT.Wakeup</a></li>
	<li><a href="#icompatibleworkbenchpage">Support of Eclipse 2.0 plug-ins via ICompatibleWorkbenchPage removed</a></li>
</ol>

<hr>

<!-- ############################################## -->

<h2>1. <a name="locale">Eclipse context key Translation.LOCALE provides the Locale type</a></h2>
<p><strong>What is affected:</strong> Clients that are getting the Locale injected.
</p>
<p><strong>Description:</strong>
The <code>Translation.LOCALE</code> key allows clients to get the current Locale injected. The
type has changed from String to Locale.
<p><strong>Action required:</strong> Clients that directly use API listed above should remove any references to it.
</p>

<!-- ############################################## -->
<h2>2. <a name="xinternal">Package org.eclipse.e4.ui.workbench.addons.splitteraddon marked as non-API</a></h2>
<p><strong>What is affected:</strong> Clients accessing the package.
</p>
<p><strong>Description:</strong>
The packages of <code>org.eclipse.e4.ui.workbench.addons</code> should all be internal API as the platform team
want to have the freedom to adjust them. Unfortunately it was forgotten to mark <code>org.eclipse.e4.ui.workbench.addons.splitteraddon</code> as
internal in 4.4.

<p><strong>Action required:</strong> Clients that directly use API listed above should remove any references to it.
</p>

<!-- ############################################## -->
<h2>3. <a name="deprecatedevents">New monitoring events added in place of SWT.Sleep and SWT.Wakeup</a></h2>
<p><strong>What is affected:</strong> Clients using the SWT.Sleep and SWT.Wakeup events.
</p>
<p><strong>Description:</strong>
<code>SWT.Sleep</code> and <code>SWT.Wakeup</code> events introduced in 4.4 are now deprecated in favour of the more generic events <code>SWT.PreExternalEventDispatch</code> and <code>SWT.PostExternalEventDispatch</code>, respectively.
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=444303#c1">Bug report for this change</a>
<p><strong>Action required:</strong> Clients that were written using the old event names should be updated to refer to the new events.
</p>

<!-- ############################################## -->
<h2>4. <a name="icompatibleworkbenchpage">Support of Eclipse 2.0 plug-ins via ICompatibleWorkbenchPage and org.eclipse.ui.workbench.compatibility removed</a></h2>
<p><strong>What is affected:</strong> Clients using ICompatibleWorkbenchPage and org.eclipse.ui.workbench.compatibility.
</p>
<p><strong>Description:</strong>
The ICompatibleWorkbenchPage interface and the org.eclipse.ui.workbench.compatibility plug-in have been removed. Please note that the support for 2.0 plug-ins was already removed in the past.
<a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=431178">Bug report for this change</a>
<p><strong>Action required:</strong> Clients that were using this interface and this plug-in must update.
</p>

</body>
</html>
